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PREFACE 


This document provides general information about the DOS/BATCH 
device drivers which handle I/O transfers between the PDP-11 and its 
peripheral devices. A sample listing of the Line Printer Driver is 
provided in Appendix B. 


NOTE 

The software described in this manual 
is furnished to purchaser under a li- 
cense for use on a single computer 
system and can be copied (with inclu- 
sion of DEC’S copyright notice) only 
for use in such system, except as may 
otherwise be provided in writing by DEC. 


This document is for information pur- 
poses and is subject to change without 
notice . 


DEC assumes no responsibility for the 
use or reliability of its software on 
equipment which is not supplied by DEC. 
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CHAPTER 1 


USING DEVICE DRIVERS OUTSIDE DOS/BATCH 


Subroutines to handle I/O transfers between a PDP-11 and each of 
its peripheral devices are developed as required for use within the 
Disk Operating System DOS/BATCH. These subroutines are made available 
within an I/O Utilities Package for the benefit of PDP-11 users who 
have configurations unable to support DOS/BATCH or who wish to run 
programs outside DOS/BATCH control. 

All the subroutines associated with one peripheral device form 
an entity known as a driver. This manual provides a general descrip- 
tion of a driver and shows how it can be used in a stand-alone environ- 
ment. The unique properties of each driver are discussed in separate 
documents, which are supplements to this manual. The I/O Utilities 
Package for any system is determined by the peripherals of that system. 
Thus, the full documentation for a particular Package consists of this 
document and applicable supplements. 
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CHAPTER 2 


DRIVER FORMAT 


2 . 1 STRUCTURE 


The basic principle of all drivers under the DOS/BATCH Monitor 
is that they must present a common interface to the routines using 
them in order to provide device-independent operation. The subroutines 
are structured to meet this end. Moreover, a driver can be loaded 
anywhere in memory under Monitor Control. Its code is always position- 
independent (PIC) . * 

A detailed description of a driver is found in Appendix A. This 
section describes driver interfaces. 

2.1.1 Driver Interface Table 

The first section of each driver is a table which contains, in 
a standard format, information on the nature and capabilities of the 
device it represents and entry points to each of its subroutines. The 
calling program can use this table as required, regardless of the 
device being called. 

2.1.2 Setup Routines 

Each driver is expected to handle its device under the PDP-11 
interrupt system. When called by a program, therefore, a driver 
subroutine merely initiates the action required by setting the device 
hardware registers appropriately. It returns to the calling program 
by a standard subroutine exit. 

The main setup routine prepares for a data transfer to or from 
the device, using parameters supplied by the calling program. Normally, 
blocks of data will be moved at each transfer. The driver will return 
control to the program only when the whole block has been transferred 
or when it is unable to continue because there is no more data avail- 
able. 

* See DOS/BATCH Assembler (MACRO) Programmer's Manual for information 
on PIC. 
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The driver can also contain subroutines by which the calling 
program can request (1) start-up or shut-down action, such as leader 
or trailer functions for a paper tape punch, or (2) some special 
function provided by the device hardware (or a software simulation of 
that for some similar device), e.g., rewind of a magnetic tape or 
DECtape . 

2.1.3 Interrupt Servicing 

The driver routine to service device interrupts is particularly 
depemdent upon the device hardware provisions for controlling transfers. 
In general, the driver determines the cause of the interrupt and checks 
whether the last action was performed correctly or was prevented by 
some error condition. If more device action is needed to satisfy the 
program request, the driver again initiates that action and takes a 
normal interrupt exit. If the program request has been fully met, 
control is returned to the program at an address supplied at the time 
of the request. 

2.1.4 Error Handling 


Device errors can be handled in two ways. There are some errors 
for which recovery can be programmed; the driver will, if appropriate, 
attempt this itself (as in the case of parity or timing failure on a 
bulk-storage device) or will recall the program with the error condi- 
tion flagged (as at the end of a physical paper tape) . Other errors 
normally require external action, perhaps by an operator. The driver 
calls a common error handler based on location 34 (IOT call) with 
supporting information on the processor stack to handle such errors. 

2 . 2 INTERFACE TO THE DRIVER 


2.2.1 Control Interface 


The principle link between a calling program and any driver sub- 
routine is the first word of the driver table (link word) . In order 
to provide the control parameters for a device operation, the calling 
program prepares a list in a standardized form and places a pointer 
to the list in the link word. The called driver uses the pointer to 
access the parameters. If the driver need return status information, 
it can place it in the list area via the link word. The first word 
of the driver table can also act as a busy indicator; if it is 0 , the 


2-2 



driver is not currently performing a task, but if it contains a list- 
pointer, the driver can be assumed to be busy. Since most drivers sup- 
port only one job at a time, the link word state is significant. 

2.2.2 Interrupt Interface 

Although the driver expects to use the interrupt system, it does 
not itself ensure that its interrupt vector in the memory area below 
400 g has been set up correctly? the Monitor takes care of this. 

However, the driver table contains the information required to initialize 
the appropriate vector. 
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CHAPTER 3 


STAND-ALONE USE 


Because each driver is designed for operation within the device- 
independent framework of the Monitor, it can be similarly used in 
other applications. Since the easiest way to use the driver is to 
assemble it with the program that requires it, this method will be 
described first. Other possible methods will be discussed later. 

3.1 driver Assembled with program 


3.1.1 Setting Interrupt Vector 

As noted in paragraph 2.2.2, the calling program must initialize 
the device transfer vector within memory locations 0-377. The address 
of the driver's interrupt entry point can be identified on the source 
listing by the symbolic name which appears as the content of the 
Driver Table Byte, DRIVER+5. The priority level at which the driver 
expects to process the interrupt is at byte DRIVER+6. For a program 
which can use position-dependent code, the setup sequence might be: 

MOV #DVRINT , VECTOR ;SET INT. ADDRESS 

MOVB DRIVER+6 , VECTOR+2 ;SET PRIORITY 

CLRB VECTOR+3 ; CLEAR UPPER STATUS BYTE 

(where the Driver Table shows at DRIVER+5: .BYTE DVRINT-DRIVER) . 


If the program must be position-independent, it can take advantage 
of the fact that the Interrupt Entry address is stored as an offset 
from the start of the driver, as illustrated above. In this case, a 
sample sequence might be: 


MOV 

PC,R1 

; GET DRIVER START 

ADD 

#DRIVER-. ,R1 


MOV 

#VECT0R,R2 

; . . . & VECTOR ADDRESSED 

CLR 

@R2 

? SET INT. ADDRESS 

MOVB 

5 (Rl) , @R2 

; . . .AS START ADDRESS+OFFSET 

ADD 

Rl, (R2) + 


CLR 

@R2 

; SET PRIORITY 

MOVB 

6 (Rl) , @R2 
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3,1.2 Parameter Table for Driver Call 


For any call to the driver, the program must provide a list of 
control arguments mentioned in paragraph 2.2.1. This list must adhere 
to the following format 1 : 


[SPECIAL FUNCTION POINTER] 2 
[BLOCK NO.] 3 

STARTING MEMORY ADDRESS FOR TRANSFER 

NO. OF WORDS to be transferred (2's complement) 

STATUS CONTROL showing in Bits: 

0-2 Function (octally 2=WRITE, 4=READ) 4 
8-10 Unit (if Device can consist of several, 
e.g., DECtape) 

11 Direction for DECtape travel (0 = Forward) 

ADDRESS for RETURN ON COMPLETION 
[RESERVED FOR DRIVER USE] 5 


The list can be assembled in the required format if its content will 
not vary. The driver can return information in this area as described 
in a later paragraph; however, this will not corrupt the program data 
and it is cleared by the driver before it begins its next operation. 


On the other hand, most programs will probably use the same list 
area for several tasks or even for different drivers. In this case, 
the program must contain the necessary routine to set up the list for 
each task before making the driver call, perhaps as illustrated in the 
next paragraph. It must be noted, however, that the driver may refer 
to the list again when it it recalled by an interrupt or to return 
information to the calling program. Therefore, the list must not be 
changed until any driver has completed a function requested; for con- 
current operations, different list areas must be provided. 


1 In some cases, it can be further extended as discussed in later para- 
graphs. 

2 Required only if Driver is being called for Special Function; addresses 
a Special Function Block. 

3 Required only if the Device is bulk storage (e.g.. Disk or DECtape). 

4 Most devices transfer words regardless of -heir content, i.e., ASCII 
or Binary. Some devices (e.g.. Card Reader) may be handled differently 
depending on the mode for these. Bit 0 must also be set to indicate 
ASCI 1=0 , Binary=l. In these cases, the driver always produces or 
accepts ASCII even though the device itself uses some other code. 

5 This word may be omitted if the device is bulk storage (see below) . 
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3.1.3 Calling the Driver 


To enable the driver to access the parameter list, the program 
must set the first word of the driver to an address six bytes less 
than that of the word containing MEMORY START ADDRESS * It can then 
directly call the driver subroutine required by a normal JSR PC,xxxx 
call. 


As an example, the following position-independent code might 
appear in a program which wishes to read Blocks #100-103 backward from 
DECtape unit 3 into a buffer starting at address BUFFER. 


WAIT: 


TABLE : 


MOV 


PC,R0 

ADD 


#TABLE+12-. ,R0 

MOV 


PC,@R0 

ADD 


#RETURN- . , @R0 

MOV 


#5404 (R0) 

MOV 


#-1024., -(R0) 

MOV 


PC,- (R0) 

ADD 


#BUFFER-. ,@R0 

MOV 


#103, -(R0) 

CMP 


“ (R0) ,-(R0) 

MOV 


R0,DT 

JSR 

• 

• 


PC, DT.TFR 

• 

. 

.WORD 

0 


.WORD 0 


.WORD 

0 


.WORD 

0 


.WORD 

0 



; GET TABLE ADDRESS 

; GET AND STORE... 

; . . . RETURN ADDRESS 
; SET READ REV. UNIT 3 
; 4 BLOCKS REQUIRED 
; GET AND STORE 
;... BUFFER ADDRESS 
? START BLOCK 

; SUBTRACT 4 FROM POINTER 
; SET DRIVER LINK 
; GOTO TRANSFER ROUTINE 
? RETURNS HERE WHEN 
;... TRANSFER UNDER WAY 
? RETURNS HERE WHEN 
; . . .TRANSFER COMPLETE 
; LIST AREA SET 
;...BY ABOVE SEQUENCE 


3.1.4 User Registers 

During its setup operations for the function requested, the 
driver assumes that Processor Registers 0-5 are available for its use. 
If their contents are of value, the program must save them before the 
driver is called. 


While servicing intermediate interrupts, the driver may need to 
save or restore its registers. It expects to have two subroutines 
available for the purpose (provided by the Monitor) . It accesses them 
via addresses in memory locations 44 g (S.RRES for restores) using the 
sequence: 

MOV @#44, -(SP) ; OR 'MOV @#46, -(SP) 

JSR R5,@(SP)+ 
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It must also ensure that their start addresses are set into the 
correct locations (44^ and 46 Q ) • 

At its final interrupt, the driver saves the contents of Registers 
0-5 before returning control to the calling program completion return. 

3.1.5 Returns From Driver 


As shown in the example in paragraph 3.1.3, the driver returns 
control to the calling program immediately after the JSR as soon as 
it has set the device in motion. The program can wait or carry out 
alternative operations until the driver signals completion by return- 
ing at the address specified (i.e., RETURN above). Prior to this, the 
program must not attempt to access the data being read in, nor refill 
a buffer being written out. 

The program routine beginning at address RETURN varies according 
to the device being used. In general, the driver has given control 
to the routine for one of two reasons; namely, the function has been 
satisfactorily performed, or it cannot be carried out due to some 
hardware failure with which the driver is unable to cope, though the 
program may be able to do so* In the latter case, the driver uses 
the STATUS word in the program list to show the cause: 

Bit 15 ~ 1 indicates that a device or 

timing failure occurred and the 
driver has not been able to 
overcome this, perhaps after several 
attempts. 

Bit 14 = 1 shows that the end of the available 

data has been reached. 

The driver places in R0 the content of its first word as a pointer 
to the list concerned. 

In addition, the driver can have transferred only some of the 
data requested. In this case, it will show in the RESERVED word of 
the program list a negative count of the words not transferred in 
addition to setting Bit 14 of the STATUS word. As mentioned in the 
note in paragraph 3.1.2, this applies only to non-bulk storage devices. 
The drivers for DECtape or disks 1 always endeavor to complete the full 
transfer, even beyond a parity failure, or they take more drastic 
action (see paragraph ^3.1.6) . 

A This includes RFll Disk? although this is basically word-oriented, it 
is assumed to be subdivided into 64-word blocks. 
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It is thus the responsibility of the program RETURN routine to 
check the information supplied by the driver in order to verify that 
the transfer was satisfactory and to handle the error situations 
appropriately . 

In addition, the routine must contain a sequence to take care of 
the Processor Stack, Registers, etc. As noted earlier, the driver 
takes the completion return address after an interrupt and has saved 
Registers J2f~5 on the stack above the Interrupt Return Address and 
Status. The program routine should, therefore, contain some sequence 
to restore the processor to its state prior to such interrupt, e.g., 
using the same Restore subroutine illustrated earlier: 

MOV @#46,- (SP) ; CALL REGISTER RESTORE 

JSR R5,@(SP)+ 

. 

RTI ? RETURN TO INTERRUPTED PROG. 

3.1.6 Irrecoverable Errors 


All hardware errors other than those noted in the previous para- 
graph are more serious in that they cannot normally be overcome by the 
program or by the driver on its behalf. Some of these could be due to 
an operator fault, such as neglecting to turn a paper tape reader to on 
or to set the correct unit number on a DECtape transport. Once the 
operator has rectified the problem, the program could continue. Other 
errors, however, will require hardware repair or even software repair, 
e.g., if the program asks for Block 2000 on a device having a maximum 
of 1000 . In general, all these errors will result in the driver 
placing identifying information on the processor stack and calling IOT 

to produce a trap through location 34 Q . 

o 

Under DOS/BATCH, the Monitor provides a routine to print a tele- 
printer message when this occurs. In a stand-alone environment, the 
program using the driver must itself contain the routine to handle the 
trap (unless the user wishes to modify the driver error exits before 
assembly) • The handler format will depend upon the program. Should 
it wish to take advantage of the information supplied by the driver, 
the format is as follows: 
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(SP) : 

Return 

Address 

(SP) : 

Return 

Status 

(SP) : 

Error 

No. Code 

(SP) : 

Error 

Type Code 


(SP) : 

Additional 


Information 


Stored by IOT Call 

generally unique to driver 
1 = Recoverable after Opera' 
tor Action 
3 = No recovery 
Such as content of Driver, 
Control Register, Driver 
Identity, etc. 


As a rule, the driver will expect a return following the IOT call in 
the case of errors in Type 1 but will contain no provision following 
a return from Type 3. 

3.1,7 General Comment 


The source language of each driver has been written for use with 
DOS/BATCH and contains some code which will not be accepted by the 
Paper Tape Software PAL-11R, in particular, .TITLE, • GLOBL , and 
Conditional Assembly directives. Such statements should be deleted 
before the source is used. Similarly, an entry in the driver table 
gives the device name as • RAD50 1 DT 1 to obtain a specifically packed 
format used internally by DOS/BATCH. If the user wishes to keep the 
name, for instance, for identification purposes as discussed in 
section 3.3, . RAD50 might easily be changed to .ASCII without detri- 
mental effect, or it might be replaced with .WORD 0. 

3.2 DRIVERS ASSEMBLED SEPARATELY 


Rather than assemble the driver with every program requiring its 
availability, the user may wish to hold it in binary form and attach 
it to the program only when loaded. This is readily possible? the 
only requirement is that the start address of the driver should be 
known or be determinable by the program. 

The example in paragraph 3.1.2 showed that the Interrupt Servicing 
routine can be accessed through an offset stored in the Driver Table. 
The same technique can be used to call the setup subroutines, as 
these also have corresponding offsets in the Table, as follows: 


DRIVER+7 

Open 1 

+10 

Transfer 

+11 

Close 1 

+12 

Special Functions 


1 If the routine is not provided, these are 0 
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The problem is the start address. There is the obvious solution of 
assembling the driver at a fixed location so that each program using 
it can immediately reference the location chosen. This ceases to be 
convenient when the program has to avoid the area occupied by the 
driver. A more general method is to relocate the driver as dictated 
by the program using it, thus taking advantage of the position- 
independent nature of the driver. The Absolute Loader, described in 
the Paper Tape Software Handbook DEC-ll-XPTSA-A-D, Chapter 6, provides 
the capability to continue a load from the point at which it ended. 
Using this facility to enter the driver immediately following the 
program, the program might contain the following code to call the sub- 
routine to perform the transfer illustrated in paragraph 3.1.3. 


MOV 

PC,R1 

ADD 

#PRGEND-. ,R1 

MOV 

PC,R0 

ADD 

• 

#TABLE+12-. , 

• 

• 

CMP 

-(R0) ,-(R0) 

MOV 

R0 f @R1 

CLR 

-(SP) 

MOVB 

10 (Rl) ,@SP 

ADD 

(SP)+,R1 

JSR 

PC , @Rl 


? GET DRIVER START ADDRESS 

; GET TABLE ADDRESS 
; AND SET UP AS SHOWN 
; . . .IN SECTION 3.1.3 


; FINAL POINTER ADJUSTMENT 
; STORE IN DRIVER LINK 
; GET BYTE SHOWING... 

;... TRANSFER OFFSET 
; COMPUTE ADDRESS 
; GO TO DRIVER 


PGRENDs 

.END 


This technique can be extended to cover situations in which several 
drivers are used by the same program, provided that it takes account 
of the size of each driver (known because of prior assembly) and the 
drivers themselves are always loaded in the same order. 


For example, to access the second driver, the above sequence 
would be modified to: 


MOV PC, R1 

ADD #PRGEND-.,R1 

ADD #DVR1SZ,R1 


; GET DRIVER 1 ADDRESS 
? STEP TO DRIVER 2 


DVRlSZ=n 
PRGEND : 

.END 
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An alternative method may be to use the Relocatable Assembler 
PAL-11S in association with the Linker program LINK-11S, both of which 
are available through the DECUS Library. The start address of each 
driver is identified as a global. Any calling programs need merely 
include a corresponding • GLOBL statement , e.g., • GLOBL DT. 

3 . 3 DEVICE-INDEPENDENT USAGE 


As mentioned earlier , the drivers are assigned for use in a 
device-independent environment, i.e. f one in which a calling program 
need not know in advance which driver has been associated with a table 
for a particular execution run. One application of this type might be 
to allow line printer output to be diverted to some other output 
medium because the line printer is not currently available. Another 
might be to provide a general program to analyze data samples although 
these on one occasion might come directly from an Analog-to-Digital 
converter and on another be stored on a DECtape because the sampling 
rate was too high to allow immediate evaluation. 

Programs of this type should be written to use all the facilities 
that any one device might offer, but not necessarily all of them. 

For instance, the program should ask for start-up procedures because it 
may sometime use a paper tape punch which provides them, even though it 
may normally use DECtape which does not. As noted in paragraph 2.2.1, 
the driver table contains an indication of its capabilities to handle 
this situation. The program can thus examine the appropriate item 
before calling the driver to perform some action. As an example, 
the code to request start-up procedures might be (assuming R0 already 
set to List Address) : 


MOV 

#DVRADD,R1 

TSTB 

2 (Rl) 

BPL 

NOOPEN 

MOV 

R0,@R1 

CLRB 

-<SP) 

MOVB 

7 (Rl) ,@SP 

ADD 

(SP) +,R1 

JSR 

PC , CRl 


NOOPEN : 


GET DRIVER ADDRESS 
BIT 7 SHOWS... 

...OPEN ROUTINE PRESENT 
STORE TABLE ADDRESS 
BUILD ADDRESS 
...OF THIS ROUTINE 

...AND GO TO IT 
FOLLOWED POSSIBLY BY 
WAIT AND COMPLETION 
PROCESSING 

RETURN TO COMMON OPERATION 
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Similarly , the indicators show whether the device is capable of 
performing input or output, or both; whether it can handle ASCII or 
binary data; whether it is a bulk storage device capable of supporting 
a directory structure or is a terminal-type device requiring special 
treatment, and the like. Other table entries show the device name as 
identification and how many words it might normally expect to transfer 
at a time (in 16-word units) . All of the information can be readily 
be examined by the calling program, thus enabling the use of a common 
call sequence for any I/O operation, as for example: 



MOV 

#DVRADR,R5 


JSR 

R5, IOSUB 


BR 

WAIT 


.WORD 

10 


.WORD 

103 


.WORD 

BUFFER 


.WORD 

-256. 


.WORD 

404 


.WORD 

RETURN 


.WORD 

0 

WAIT: 

# 


IOSUB : 

• 

• 

MOV 

@SP,R0 


MOV 

R5,R1 


TST 

• 

• 

(Rl) + 


MOV 

@R1,R1 

ADD 

R0,R1 

CLR 

“(SP) 

MOVB 

@Rl , @SP 

ADD 

R0, @SP 

JSR 

PC,@(SP)+ 

RTS 

R5 


; SET DRIVER START 
; CALL SET UP SUB 

; SKIP TABLE FOLLOWING ON RETURN 
; TRANSFER REQUIRED 
; BLOCK NO. 

; BUFFER ADDRESS 
; WORD COUNT 
; READ FROM UNIT 1 
; EXIT ON COMPLETION 
; RESERVED 
; CONTINUE HERE... 


; PICK UP DRIVER ADDR 
; SET UP POINTER TO LIST 
; BUMP TO COLLECT CONTENT 
; ROUTINE CHECKS ON DEVICE 
.CAPABILITY USING R1 
; . . .TO ACCESS LIST AND 
; . . . R0 THE DRIVER TABLE 
; IF O.K. . . . 

; GET ROUTINE OFFSET 

; USE IT TO BUILD 
;... ENTRY POINT 

; CALL DRIVER 
; EXIT TO CALLER 


The calling program, or a subroutine of the type just illustrated, may 
also wish to take advantage of a feature mentioned earlier: the fact 
that when a driver is in use its first word will be non-zero. The 
driver itself does not clear this word except in special cases shown 
in the description for the driver concerned. If the program itself 
always ensures that it is set to zero between driver tasks, this word 
forms a suitable driver-busy flag. Under DOS, the program parameter 
list is extended to allow additional words to provide linkage between 
lists as a queue of which the list indicated in the driver first word 
is the first link. 
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The preceding paragraphs are intended to indicate possible ways 
of incorporating the drivers available into the type of environment 
for which they were designed. The user will probably find others. 
However, he should carefully read the more detailed description of 
the driver structure in Appendix A, and the individual driver specifi- 
cations before determining the final form of his program. 

A word of warning is appropriate here. Although most drivers set 
up an operation and then wait for an interrupt to produce a completion 
state, there are some cases in which the driver can finish its required 
task without an interrupt, e.g., "opening" a paper tape reader involves 
only a check on its status. Moreover, where "Special Functions" are 
concerned, the driver routine may determine from the code specified 
that the function is not applicable to its device, and therefore, 
will have nothing to do. In such cases, the driver clears the inter- 
mediate return address from the processor stack and immediately takes 
the completion return. Special problems can arise, however, if the 
driver concerned is servicing several tasks, any of which can cause a 
queue for the driver's services under DOS/BATCH. To overcome these 
problems, the driver expects to be able to refer to flags outside the 
scope of the list so far described. This can mean that a program 
using such a driver may also need to extend the list range to cover 
such possibilities. Particular care should be exercised in such cases. 
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APPENDIX A 


I/O DRIVERS WITHIN THE DOS/BATCH OPERATING SYSTEM 


The principal function of an I/O driver is to satisfy a Monitor 
processing routine's requirement for the transfer of a block of data in 
a standard format to or from the device it services. This will involve 
both setting up the device hardware registers to cause the transfer 
and its control under the interrupt scheme of PDP-11, making allowance 
for peculiar device characteristics (e.g,, conversion to or from ASCII 
if some special code is used) . 

It may also include routines for handling device start-up or shut- 
down such as punching leader or trailer, and for making available to 
the user certain special features of the device, such as rewind of mag- 
tape. 


A, 1 DRIVER STRUCTURE 


In order to provide a common interface to the monitor, all 
drivers must begin with a table of identifying information as follows: 


BUSY FLAG (initially 0 ) 

FACILITY INDICATOR (expanded below) 

Offset to 

Interrupt Routine* 

Standard Buffer Size 
in 16-word Units. 

Offset to 

OPEN Routine* 

Priority for 

Interrupt Service* 

Offset to 

CLOSE Routine* 

Offset to 

Transfer Routine* 

Space 

Offset to 

Special Functions* 

DEVICE NAME (Packed Radix-50) 


Offsets marked * will enable calling routine 
to indicate routine required. They will be 
considered to be an unsigned value to be 
added to the start address of the driver. 

This may mean that with a 256-word maximum, the 
instruction referenced by the offset will be 
JMP or BR (routine) . 
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Bits in the Facility Indicator Word define the device for monitor 
reference; 


SPECIAL STRUCTURES 


GENERAL STRUCTURE 


15 14 13 12 


t t 


File- 
Structured 

Device DEC- 
tape (or 
similarly 
reversible) 

magtape- 


11 10 9 8 


1 0 


Unused * Unused] 

"Terminal" 

Device 

Contains OPEN 
Contains CLOSE 
Contains SPECIAL 


*=Multi-unit System 

type devices (i.e., RK disk). 


t 


Multi User 


Output Device 

Input Device 
Binary Device 
ASCII Device 


The table should be extended as follows if the device is file- 
structured: 



Unit 0 

Similar Bit- 
Map Pointers 
for Multi- 
Unit Devices 


The driver routines to set up the transfer and control it under 
interrupt, and possibly for OPEN, CLOSE, and SPECIAL, follow the table 
Their detailed operation will be described later. 

A. 2 MONITOR CALLING 


When a Monitor I/O processing routine needs to call the driver, 
it first sets up the parameters for the driver operation in relevant 
words of the appropriate DDB 1 , as follows: 


"i 

Dataset Data Block - in full, a 16-word table which provides the main 
source of communication between the Monitor drivers and a particular 
set of data being processed on behalf of a using program. 
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XYZ : 


User Call Address) 


SPECIAL FUNCTION CODE 


DEVICE BLOCK NUMBER 


MEMORY BLOCK ADDRESS 


WORD COUNT ( 2 1 s Complement) 

TRANSFER FUNCTIONS (expanded below) 
COMPLETION RETURN ADDRESS 


(DRIVER WORD-COUNT RETURN) Set to Zerd 


User Line 


Address) 


The relevant content of the Transfer Function word is as follows: 


EOF 

or 

EOD 


TT Echo Control 


▼ 




▼ 



15 14 

13 

12 11 10 9 8 7 6 5 

4 

3 

2 

1 0 


t 


Used by Driver 
to indicate 
Hardware Parity 
Fail 



DECtape 
reverse DEVICE 
UNIT 


t 


Open vs, 
Closed 


H 


£ 


=ASCII 

Binary 


Transfer 


Transfer OUT 
IN 


Provided that the Facility Indicator in the Driver Table 
described above shows that the driver is able to satisfy the request, 
both from the point of view of direction and mode and of the service 
required, the Monitor routine places in Register 1 the relative byte 
address of the entry in the Driver Table containing the offset to the 
routine to be used (e.g., for the Transfer routine, this would be 10). 
It then calls the Driver Queue Manager, using HSR PC,S.CDB. 




The Driver Queue Manager assures that the driver is free to 
accept the request, by reference to the Busy Flag (Word 0 of the 
driver table) . If this contains 0 , the Queue Manager inserts the 
address of the DDB from Register 0 and jumps to the start of the 
routine in the driver using Register 1 content to evaluate the address 
required. If the driver is already occupied, the new request is placed 
in a queue linking the appropriate DDB 1 s for datasets waiting for the 
driver’s services. It is taken from the queue when the driver com- 
pletes its current task. (This is done by a recall to the Queue 
Manager from the routine just serviced, using JSR PC,S.CDQ.) 

On entry to the Driver Routine, therefore, the address following 
the Monitor routine call remains as the "top 11 element of the processor 
stack. It can be used by the driver in order to make an immediate 
return to the Monitor (having initiated the function requested) , using 
RTS PC. It should also be noted that the Monitor routine will have 
saved register contents if it needs them after the device action. The 
driver may thus freely use the registers for its own operations. 

When the driver has completely satisfied the Monitor request, it 
should return control to the Monitor using the address set into the 
DDB. On such return. Register 0 must be set to contain the address 
of the DDB just serviced and since the return will normally follow 
an interrupt, Registers jZf-5 at the interrupt must be stored on top of 
the stack. 

A. 3 DRIVER ROUTINES 

A. 3.1 TRANSFER 

The sole purpose of the TRANSFER routine is to set the device in 
motion. As indicated above, the information needed to load the hard- 
ware registers is available in the DDB, whose address is contained in 
the first word of the driver. Conversion of the stored values is, of 
course, the function of the routine. It must also enable the interrupt; 
however, it need not take any action to set the interrupt vectors as 
these will have been preset by the Monitor when the driver is brought 
into core. Having then given the device GO, an immediate return to 
the calling processor should be made by RTS PC. 
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A. 3.2 Interrupt Servicing 


The form of this routine depends upon the nature of the device. 

In most drivers it will fall into two parts, one for handling the 
termination of a normal transfer and the other to deal with reported 
error conditions. 

For devices which are word or byte-oriented, the routine must 
provide for individual word or byte transfers, with appropriate treat- 
ment of certain characters (e.g., TAB or Null) and for their conversion 
between ASCII or binary and any special device coding scheme, until 
either the word count in the DDB is satisfied or an error prevents this. 
On these devices, the most likely cause for such error is the detection 
of the end of the physical medium; its treatment will vary according 
to whether the device is providing input or accepting output. The 
calling program will usually need to take action in the former case 
and the driver should merely indicate the error by returning the un- 
expired portion of the word count in DDB Word 7 on exit to the Monitor. 
Output End of Data, however, will, in general, require operator action. 
To obtain this, the driver should call the Error Diagnostic Print 
routine within the Monitor by: 


MOV DEVNAM, - (SP) ; SHOW DEVICE NAME 

MOV #402,0 (SP) ; SHOW DEVICE NOT READY 

IOT ; CALL ERROR DIAGNOSTIC PRINT ROUTINE 


On the assumption that the operator will reset the device for further 
output and request continuation, the driver must follow the above 
sequence with a Branch or Jump to produce the desired resumption of 
the transfer. 

Normal transfer handling on blocked devices (or those like RFll 
Disk which are treated as such) is probably simpler since the hardware 
takes care of individual words or bytes and the interrupt only occurs 
on completion. Errors may arise from many more causes, and thier 
handling is, as a result, much more complex and device dependent. In 
general, those which indicate definite hardware malfunctions must lead 
to the situation in which the operator must be informed by diagnostic 
message and the only recourse after rectification will be to start the 
program over. 
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At the other end of the scale there are errors which the driver 
itself can attempt to overcome by restarting the transfer - device 
parity failure on input is a common example. If a retrial, or several, 
still does not enable a satisfactory conclusion, the driver should 
normally allow programmed recovery and merely indicate the error by 
Bit 15 of DDB word 5. Nevertheless, because the program may wish to 
process the data despite the error, the driver should attempt to 
transfer the whole block requested if this has not already been effected. 
Between these two extremes, the remaining forms of error must be 
processed according to the type of recovery deemed desirable. 

Whether the routine uses processor registers for its operation or 
not will naturally depend on considerations of the core space saved 
against the time taken to save the user's content. However, on com- 
pletion (or error return to the Monitor) , as indicated in an earlier 
paragraph, the calling routine expects the top of the stack to contain 
the contents of Registers 0-5 and Register 0 to be set to the address 
of the DDB just serviced. The driver must therefore, provide for 
this. 


A. 3. 3 OPEN 

This routine need be provided only for those devices for which 
some hardware initialization by the user is required. It should not 
normally appear in drivers for devices used in a file-oriented manner. 

Its presence must be indicated by the appropriate bit (Bit 7) in the 
driver table Facility Indicator. 

The routine itself may vary according to the transfer direction 
of the device. For output devices, the probable action required is 
the transmission of appropriate data, e.g., CR/LF at a keyboard terminal, 
form-feed at a printer, or null characters as punched leader code, 
and for this a return interrupt is expected. The OPEN routine should 
then be somewhat similar to that for TRANSFER in that it merely sets 
the device goind and makes an interim return via RTS PC, waiting until 
completion of the whole transmission before taking the final return 
address in the DDB. 

On the other hand, an input OPEN will likely consist of just a 
check on the readiness of the device to provide data when requested. 

In this case, the desired function can be effected without any interrupt 
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wait. The routine should, therefore, take the completion return 
immediately. Nevertheless, it must ensure that the saved PC value 
on top of the stack from the call to S.CDB is appropriately removed 
before exit. In the case of drivers which can only service one 
dataset at a time (i.e.. Bit 0 of their Facility Pattern word is set 
to 0 ) and can never, therefore, be queued; it will be sufficient to 
use TST (SP) + to effect this. A multi-user driver, however, must allow 
for the possibility that it may be recalled to performe some new task 
waiting in a queue. This is shown by the byte at DDB-3 being non-zero. 
In this case, the intermediate return to the routine originally 
requesting the new task has already been made directly by S.CDQ to de- 
queue the driver. This return must be taken when the first routine 
has performed its Completion Return processing. Moreover, this first 
routine expects to exit as from an interrupt. When a driver is recalled 
from a queue, it must simulate this interrupt. A possible sequence 
might be; 

MOV DRIVER, R0 

MOV (SP)+,R5 

TSTB -3 (RJ2f) 

BEQ EXIT 

MOV @#177776, -(SP) 

MOV R5 , - (SP) 

SUB #14, SP 

EXIT: JMP @1— (R0) 

A. 3.4 CLOSE 

As with OPEN, this routine should provide for the possibility of 
some form of hardware shut down such as the punching of trailer code 
and it is not necessary for file-structured devices. Moreover, it is 
likely to be a requirement for output devices only. If it is provided. 
Driver Table Facility Indicator (Bit 6) must be set. 

Again, the probable form is initialization of the hardware action 
required, with immediate return via RTS PC and eventual completion 
return via the DDB-stored address. 

A. 3. 5 SPECIAL 

This routine may be included if either the device itself contains 
the hardware to perform some special function or there is a need for 
software simulation of each hardware on other devices, e.g., tape re- 
wind. It should not be provided otherwise. Its presence must be indi- 
cated by Bit 5 of the Facility Indicator. 


; PICK UP DDB ADDRESS 
; SAVE INTERIM RETURN 
; COME FROM QUEUE? 

; IF SO, STORE STATUS 
? . . . & RETURN 
; DUMMY SAVE REGS 
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The function itself is stored by the Monitor as a code in the DDB 
as shown earlier. When called, the driver routine must determine 
whether such function is appropriate in its case. If not, the com- 
pletion return should be taken immediately with prior stack clearance, 
as discussed under OPEN. For a recognized function, the necessary 
routine must be provided. Again, its exit method will depend upon the 
necessity for an interrupt wait or otherwise. 

A. 4 DRIVERS FOR TERMINALS 


The rate of input from terminal devices is normally dictated 
externally by the operator, rather than being program-driven; moreover, 
for both input and output, the amount of data to be transferred on each 
occasion may be a varying value, i.e., a line rather than a block of 
standard size. Furthermore, there may be problems with the conflict 
between echo of input during output. As a result, drivers for such 
devices will demand special treatment. 

Normal output operation, ie.e,. WRITE by the program, is handled 
by the Monitor Processor. On recognizing that the device being used 
is a terminal, as shown by Bit 8 of the facility indicator, this 
routine always causes a driver transfer at the end of the user line, 
even though the internal buffer has not been filled. The driver, 
however, is given the whole of a standard buffer, padded as necessary 
with nulls. Provided the driver can ignore these, the effect is that 
of just a line of output. 

Input control on the other hand, must remain driver responsibility. 
Overcoming the rate problem will, in most cases, require circular buffer- 
ing within the driver until demanded by the Monitor. At this point, 
transfer of data already in should occur. If this is sufficient to 
fill the monitor buffer, the driver can await the next request before 
further transfer onward. If insufficient, it should operate as any 
other device and use subsequent interrupts to continue to satisfy 
the Monitor request. It must, nevertheless, stop any transfer at the 
end of a line in normal operation. In order to allow the Monitor to 
continue, the driver must simulate the filling of the buffer by null 
padding (of no consequence, since terminals are by nature character- 
based) . (Normal operation, of course, means response to user .READ'S 
and is indicated by the size of the buffer to be filled, namely the 
driver standard. Should the user be requesting .TRAN's, the buffer 
size will vary from the standard in all likelihood and the driver may 
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size will vary from the standard in all likelihood and the driver may 
then assume he requires operation as a normal device — complete buffer 
fill-up before return,) 

Where input echo is a further complexity, there will doubtless 
be other requirements. If the echo is made immediately after the input, 
it may be desirable to have a second buffer to cater for the likely 
situation that the echo, will not exactly match its origin. On the 
other hand, if the echo is held for any length of time, perhaps to 
provide correct relations between program-driven output and the echo, 
the second buffer could be too expensive. A larger input buffer and 
routines to allow for several outputs to one input character while 
sitting on that character might be more convenient. The conflict 
between such echo and program-driven output will require controlled 
switching within the driver input and output handlers. 
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APPENDIX B 


SAMPLE LINE PRINTER DRIVER LISTING 


The following is a sample listing of a DOS/BATCH Device Driver* 
The actual driver is the LP11 Line Printer Driver (for device name LP 
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0 V , MACRO \hfti-<OZ 17-JUL-7S <^2*3^ F-A&t \ 


1 


• 

f 

j I u l rAL 

LUulHMtr ■ r CORPORATION, MAYNARD, MASSACHUSETTS 01 

2 


? 

COPYRIGHT, l srf 7 .3 

3 


? 



4 


0 

1 J I b 1 [ AL 

EQUIPMENT CORPORATION ASSUMES no RESPONSIBILITY 

•3 


J 

b U ri THE 

USE Ur RELIABILITY OP ITS SOFTWARE ON EQUIPMENT 

6 

t 


} 

"-11CH IS .NUT SUPPLIED BY DIGITAL EQUIPMENT CORPORATION. 

/ 

a 


1 

/ 

VERSION 

NUMbcfc: v 1 3 . 0 1 

9 

14 


i 

i 

uated: 

MARCH 5 f 1973 

i l 


• 



12 


} 

DEVICE 

DRIVE* FOR THE LP11/LS11 LIKE POINTER (S) 

13 


0 



U 


; 

UK I V ER 

PAKAHtTEPlZATION SYMBOLS 

15 


* 

9 


LHUr LSU, WIDTH, SPACES, SPREAD 

15 


0 



17 





la 



nib 

NUF, UPTYP 

19 


UPTyP 

n 

0 

23 



• feNOC 


21 



.IF 

tu , lptyp 

22 



UTLt 

D v . u * 0 

26 

0 0 0 Vj '/) 1 

urn 

«i 

1 

2 4 

000012 

SKIP 2 

3 

12 

25 



.IFF 


26 



.IF 

fc.Q, <LPT yP-1> 

2/ 



. UftE 

D V • t. P 1 

28 


tsn 

s 

1 

29 


SPKfcAu 

s 

l 

00 


Sk i p 2 

a 

13 

51 



. IKF 


32 



, ;i E R K Q R 

^UNSUPPORTED LINE PRINTER 

33 



. fcNDC 


34 



.5Ni)C 


35 





36 



. IF-mUF 

wU'TH 

37 


w j u l n 

ft 

67. ) 80. COLUMN PRINTER DEFAULT 

36 



• tNOC 


39 





40 

0 £ (g tf ti *i 

R0 

a 

%0 

41 

7 J 4 0 kl 0 l 

*1 

= 

XI 

42 

0 0 7 0 «o 2 

* 2 

a 

%2 

43 

0 0 0 0 3 

«3 

r 

%3 

44 

(0 46t 0 0 £ 4 

N 4 

s 

7,4 

45 

fr:*0D 

*5 

a 

45 

45 

l£' 0 0 i7 6 

SP 

a 

%6 

4 7 

0 0 0 0 ‘0 7 

PC 

a 

%7 

46 





49 

(£' 0 0 4 0 2 

4^02 

a 

402 ; DIAGNOSTIC MESSAGE CODE 

53 





51 

000044 

S , K $ A V 

a 

4* 9 KtGlSTER SAVE (MONITOR SUPPORT 
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D V 

.UP* 

f-lACn'U V i4 1> •• (C 2 17 

* J U L m 7 3 

02!3«5 PAGE 2 



1 

2 




• is w D B L 

LP 



3 

A 




. IDENT 

/ l 3 . « 1/ 



H 

5 



l 

U06-1 1 

DEVICE DRIVER'S 

standardized interface 

b 

7 

3 6 v5 0 4 6 

0 0 0 0 0 /I 

LP1 

• * U 9 0 

0 

t 

USER’S DOB POINTER 

a 




. IF0F 

L3n*SPRtA0 



9 




• BYTE 

363 

1 

FACILITIES INDICATOR 





• £ N 0 C 




n 




•IF 4DP 

LSI IftSPRtAO 



12 

60602 

322 


• BYTE 

322 

; 

facilities indicator 

ib 




• ENDC 




14 

60043 

6 •/ A 


• ttYrfc 

0 

f 

1 

SPECIAL STRUCTURES, NONE 

lb 

0 W 00 4 

6 tf! 0 


* b y Tt: 

<<0lDTH+37»/40» 

; 

standard BUFFER SIZE 

lb 

0 0 6 4 5 

116 


• S Y Tt 

LP.I^T^LP 

? 

INTERRUPT ENTRY OFFSET 

17 

0 6 0 0 0 

2 0 0 


• BYTE 

200 

; 

INTERRUPT PRIORITY 4 

16 

vj v'j k* 4 7 

0 3 6 


• BYTE 

LP,uPm-lP 

f 

OPEN ENTRY OFFSET 

19 

4 0 0 1 0 

6 6 6 


• BYTE 

LP.IKN-LP 

? 

TRAN ENTRY OFFSET 

2tf 

0001 1 

035 


• BYTE 

LP.CLS-I.P 

; 

close entry offset 

21 




• IF 

lj.lptyp 



22 

0 0 0 12 

0 0 0 


• BYTE 

0 



2b 




. IFF 




24 




• BYTE 

LP.SPC-LP 

; 

SPECIAL ENTRY OFFSET 

2b 




.EMOC 




2b 

0 0 0 1 3 

60 4 


• BY [t 

0 

? 

spare 

27 

0 0 0 14 

fc: 4bb*M 

LP.nam: 

• ^ a D 5 0 

/LP/ 

; 

DEVICE DRIVER’S NAME 

26 








29 


6 6 A 2 0 4 

LP.THP 

s 

2 0 0 

? 

INTERRUPT VECTOR'S ADDRESS 

56 


17/514 

L P • L SR 

s 

1/7614 

? 

COMMAnO/STATUS REGISTER 

31 


177316 

UPtUbP 

a 

1/76X6 

? 

DATA BUFFER REGISTER 

32 








33 

4 0 6 1 b 

0 6 0 1 £ 4 

LP.SI41 

• ! H U U 

«ll>TM 

; 

THIS hURU IS SET BY THE INITIA 

34 

0 4 2 0 

£ 6 V- 1 3 3 

UpPCASl 

,wlMD 

133 

; 

SET TO THE HIGHER PRINT LIMIT 

3b 

0 002 2 

6 0 0 0 6 0 

qvprnt : 

• U F U 

fe 

i 

SET TO TRUE WHEN OVER PRINTING 

3b 

0i 0 6 2 4 

000064 

L P • L 1 N • 

• • Q ^ i.) 

0 

? 

ALREADY SENT (CHARACTERS) 

37 

4 06 2 6 

0 0 0 6 0 6 

Lp.bns: 

* rfUWD 

w 

i 

BLANK POSITIONS COUNTER 

36 

400 3 0 

t- 0 6 6 0 0 

lp.tc ri 

• '4 U F L) 

0 

; 

TRANSFER CHARACTER COUNT 

39 

v'i 6 0- 3 2 

k> 0 *.' * k* 0 t .l 

UP.bAUS 

* *U3D 

14 

; 

BUFFER ADDRESS POINTER 

46 








41 

A 0 ) v- 5 4 


LP.T0P 5 



; 

COMMAND DEVICE TO TOP-OF-FORM 

42 




• IFOF 

U 6 1 1 



43 




• dr TE 

21 

; 

command DEVICE TO ON-LINE 

44 




• ENOC 




4b 

A 0 0= 3 4 

015 


• BY TE 

15, H 

; 

OR, FF 


6 v) 6 3 5 

vn 4 






46 




• EVEN 




47 




• IF OF 

L31 i&SPRtAQ 



46 



LP.FLLJ 


14 

? 

character elongation flag 

49 




• E N 0 C 




56 








51 


6 6 ^ 6 4 4 

LP.LUw 

s 

40 

? 

PRI NTABILITY# LOWER LIMIT 
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QV.lHH-i 


MACRU V t* D - a 17-0uL-73 *2 l 3D PA&t 3 


1 

2 


; 

UPLN 

PRUCES3UR 



6 444460 


up.uhn: 





4 


\ 

LLU3t 

PROCESSOR 



3 3 kJ ie» 54 0 o 


LPtCLbS 





6 id 4 <6 Sr* 3 ft 

id 4 7 f> 7 

i'j <4 C • 4;^ 


J 5h 

PC.LP.STS 

9 

SIMULATE; INTERRUPT 

/ M2 

it" 0 2 7 k: 1 

1/7/72 


ADD 

IILP. IOP-..RJ 

; 

*1 * PC (BY LP.STS) 

8 (4 \A ti '* 4 r* 

<s 1 ! / 1 6 7 
1/7/ fez) 


MOV 

R1 ,1-R.OAJ 

J 

internal buffer's address 

9 



. I POP 

LSI l 



U; 



n 0 V 

u-3.UP.TCT 

; 

INITIALISE TRANSFER count 

11 



• ft N 0 C 




12 



. IP n u» P uall 



13 Vi t>2 

1 f : 2 6 7 

1 77752 


h j v 

R2.LP.TLr 

# 

*2 > -2 (by LP.STS) 

14 



• t'^oc 




13 



• I POP 

L3 1 1 SSPPt AD 



16 



C L 

LR.PLt 

; 

INITIALIZE ELONGATION FLAG 

17 

1* 

19 

k:» 4 1'» 414 


« ft ' M ) C 
bR 

LP. I N T 

# 

DISPATCH INTERNAL BUFFER 

24 



, IPuP 

LSI l&SPPtAU 



21 







22 


i 

bPcCXAL PKQCtSSOK 



23 


LP.5HC : 





24 



M 0 V 

,R1 

J 

R 1 * FUNCTION BLOCK'S ADDRESS 

23 



C-*tPb 

<* 1 . C R 1 ) 

; 

LINE ELONGATION FUNCTION ? 

2b 



bNt 

LP.S*H‘. 

; 

NO, IGNORE 

27 



' i U V 

2 1 1 1 ) , L P • P L 0 

9 

EnABLE/dISABLE ELONGATION 

28 


U P t 6 3 '3 ; 

J 4P 

A>14(R;;) 

i 

EXIT v I A COMPLETION RETURN 

29 



• ft f N 0 C 




64 







61 


» 

9 

T H A i«i 

PROCESSOR 



62 4440V 

33 4 4 V) 6 'A 

tr'"' v4 4 7 7 
it'* /i '/• 4 3 d 

lp.t**: 

JSH 

PC.LP.ST3 

9 

simulate an interrupt 

34 464 04 

f 1 o / k* 3 

1 7 7 7 1 4 


(■ 0 V 

UP » HW 

* 

9 

ha * USER'S DOS ADDRESS 

33 <7 4 4 7 4 

1 63o 7 

£ k- '3 k; 0 

1/7/34 


MOV 

6 C*!*) , LP.BAO 

t 

RETAIN BUFFER'S ADDRESS 

66 *U) s' 7 b 

3 1 p if ft 1 
it' 5 (6 v /* 1 3 

17/724 


0 V 

. L P . T C T 

/ 

RETAIN DOB'S BYTE COUNT 

3 7 i/j v-j 1 tii 4 

id 0 ft 3 c 7 

1 77723 


A SL 

LP.TCi 

; 
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QV.LP^ MjUCtfU Vft»b«i02 17-JUL-73 02*3Z PA&fc 4 


1 

3 «0 Z /■ I 1 A 

4 o z if 1 1 d 

b .0 o *116 
b * ^ * 1 2 v 3 

7 •£ tig 1 2 4 

6 * * * l 3 tf 
9 mv\ 132 

1* 

H 0013 b 

12 ’ 4*1 4 tf 

13 *S«JH 2 

1 4 / l" 14 6 
lb **132 

16 ■J'l if 1 b o 

1 / /I ki 1 o . -1 
19 /'M02 

19 00106 
2d 

21 

22 

2d 

24 

2 0 * * 1 7 * 

26 d*\/d 

27 /j * 1 7 » 

2 9 if d 2 d d 
29 <**242 


d/l Sj 42 id 

31 . 4*212 

32 0*214 

33 4*216 

34 0 022* 


3 o 002 2 b 
3b 0*23:f 

37 4*234 
o a w 2 3 © 
3 9 i) 0 2 0 6 

44 

41 ^4242 


? lAiTfcKtfUPT PftUCfcSSDR C V X A INTERRUPT VECTOR AT 2*0) 

UPt INI ; 

442737 Bit, Mtfe-#**L p t CSR 


71 it' / A / J 

1 /7b i 4 

* d 2 fe) $ 2 


BGE 

LP.lw 

«j * / 1 6 7 


J HP 

lp.eRk 

* Tit* 05 2 

LP.ia: 

T ST 

LP.TCT 

1/7/04 
z h 1 4 b 2 


ofcQ 

L P . 0 U h £ 

1 1./ 4 4 b 


M u V 

R4,- (SP) 

/ U 3 4 0 


MQV 

HS,-(SP) 

‘/ill 24 0 


M 0 V 

R2,*(5P) 

/ 1 7' 1 4 0 


MOV 

R1 ,-(SP) 

*167*54 

1 /70ftv!i 


f'iOV 

LP.HKS.P4 

w 1 6 7 •/ 3 


M 0 V 

LP.LlN.KS 

17/062 

*lft/t.2 


m 0 V 

LP.RAD.R2 

17/654 

1 1 22i l 

LP.lYlfcS 

M 0 V d 

( R 2 ) + , R 1 

* A 1 4 ‘2 6 


BfeQ 

LP.DNP 

1 2 ✓! 1 2 7 

LF.ifei ; 

L M P 6 

« 1 , uLP.LUk 

V- 0 0 /' 4 -4 

0/2442 


oL T 

LP.I10 



. i F OF 

SPACES 



HGI 

LP. 102 



INC 

H 4 



BR 

• £N0 C 

LP.TPT 

12716/ 

1 7 7 0 2 4 

LP. I«52S 

CMPb 

HI , UPPCAS 

0021 1 * 


b G t 

LP. I IS 

z 0 5 2 z 5 

LF.IM3J 

I'JC 

Hi 

0 7! 3 0 1 b 


Bor 

LP.DNP 

0 3 c. 7 3 7 

10/2/0 

L F’ • I VI 4 S 

b I T 


1/7014 

l0/b3i 


6 MX 

LP.I22 

0U1O1 7 


5 1 Q 

LP.I20 

0 050/4 


DEC 

R4 

13/4 < 4 


b m I 

LP.I0S 

1 1 2 7 3 7 

Z /1 0 Z 4 v 

1/7310 


00 VB 

»4«,«»#LP.08H 

0 0/7 6 3 


or 

LP.I43 

H /■ 1 3 7 

L P * I *d t> • 

H 0 V B 

HI.S'PLP.iJBW 

1 / 7 0 1 o 

Z 0 5 3 / 4 

L P • I v* 6 i 
lP.onp: 

CL* 

R 4 

z 0 o 2 6 7 

1 7 / b 6 a 

CP. THU 

INC 

LP.TCT 

1 3 <6 0 


b m L 

LP. 100 


; DISABLE INTERRUPT 


i segregate errors 
; enter error processor 

; any characters remaining ? 

; no, line completed 

I SAVE REGISTERS 

# 

? 

• 

> N 4 * BLANK CUUNTER 

l H3 a PRINT POSITION 

; H2 a BUFFER POINTER (ADDRESS) 

; *** access character *** 

; NULL (43) IGNORED 

; printability check 

} EXCEEDS LOWER LIMIT 

t valid character, SO FAR 
} blank 140) ISOLATED, COUNT 
l ACCESS NEXT CHARACTER 

> PRINTABILITY CHECK 

; EXCEEDS UPPER LIMIT 
J PRINTER'S WIDTH EXCEEDED ? 

; YES, DO NOT PRINT 
CSRf ACCESS ERROR/READY STATUS 


; ERROR INOICATION 
l NOT READY indication 
j decrement blank counter 
; NOT PROCESSING BLANKS 
; BLANK/HTAB EXPANSION PERFORMED 


l CONTINUE PENDING COMPLETION 

1 *** print character *** 

; Insure no blanks pending 

; INCREMENT BUFFER'S CHARACTER 
; COUNTER, ANY MORE ? 

; yes 
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OV.LP0 MACRO 17-JJL-73 02S30 PAGt S 


1 

2 


r 

f 


4 


? 


4 # # # 2 4 4 

1 0 57o/ 


TSTn 


17751 4 



5 

1 # # 1 # 2 


b^L 

6 « ✓! hi 2 1> 2 

1-; /j 4 5 c i / 

L P • o ^ fc : 

J5H 


# # k* 2 5 5 



7 4 2 5 6 

* 1 4/45 

LPtUONS 

riQV 


# 4 i/i ti 4 4 



* <M#202 

##4050 



9 0 4 0 2 o 4 

if) 1 0 7 # 4 


hQ v 


177514 



1 4 #02/ /i 

0 0 # 1 7 4 


J *P 


c^ifj jfl 0 1 4 



n 




12 ##2/4 

l 2 1 12/ 

LP.I1&I 

CMPd 


1 1 



l 5 

# # l VO J 0 


b n t 

14 


? 


15 


• 


15 


1 


17 

# 1 0 / 4 0 


i-iO v 


1/701# 



15 



. XKOP 

19 



T5T 

2# 



b £W 

21 



A 5 P 

22 



• £NOC 

2 4 4 *j 4 # 6 

#5#4l o 

up. ms 

M0U 

24 



. IF OP 

25 



bGt 

25 



CL* 

2/ 



D 


L I Mr. COMPLETED 

«#lP.CSR ; DEVICE BUSY ? 

UP.I21 i YES 

«b,l.P.SET ; RESTORE TEMPORARIES 

¥>#S.RSAV »- (SP) ; SAVE REGISTERS 

RD,fUP)+ } 

LP , R0 ! K0 « USER’S DOB ADDRESS 

S14(*0) f EXIT v 1 A COMPLETION RETURN 


K 1 » «1 1 f HORIZONTAL tab cm ? 


LP.I13 ; NO 

horizontal tab simulation via blanks 

LP.SiZ,-CSP) } PRINTER’S MAX RIOTH 


LSI 1 ^SPREAD 
LP.FUP 
Lp.m 
ISP) 


; tLONGATlON ? 

J NO 

} (PRINTER'S WIDTH) t 2 


RS, (UP) 
LSllNSPRtAD 
LR.H2 
LP. TUT 
LP.nofc 


f - PRINT POSITION 

J NOT EXCEEDED PRINTER'S WIDTH 
> elongation line termination 
; exit 


2B ,EN0C 


29 

# # 4 1 7 

#57430 UP. 112 : 

AOU 

RA, CSP) 

; + bl a nk counter 

5# 

##412 

#5?/ 1 5 

177/74 

b 1 b 

#1/7770, CSP) 

; C MODULO 8 ) - 8 

41 

42 

v a 5 l b 

152074 

iS'Jtt 

CaP) +, RA 

; + blank counter 

; * blank COUNTER 

44 

44 

4#42 # 

#07 740 

btf 

LP.TRT 

; access next Character 
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OV.UPto NAURU veft-a? 17-JGL-73 652 :30 PAGE 6 


l *my&z 

12012/ 

3 0 0 v.’ i 3 

Lh . 1 13 : 

OP 3 

HI ,*<15 

f 

carriage-return as) ? 

2 

k ! A 30 1 1 


6GT 

LP. I 1 4 

1 

NO, ABOVE 

3 <d b W 3 3 / ) 

2 0 1 0 1 4 



UP. £15 

i 

NO, BELOW 

4 0 0 3 5 2 

r 2 5 7 1? 7 

1 7 7 “ ft 4 


1 ST 

C.WPRNT 

; 

PRINT THE carriage-return ? 

6 300556 

0 if 1 » 2 3 


&-4fc 

UP. 1 16 

; 

YES 

6 3 tf i /j 3 4 3 

Ifi 1 6 7 p 3 

177452 


! * Q V 

LP.S1Z»K3 

; 

R3 » -(, PRINTER'S WIDTH) 

7 303344 

HI ■/) 3 * V. J 


h t G 

H 3 

t 


a 



• IKi> 

LSll&SPPtAO 



9 



rsT 

UP. PUB 

i 

fcUONGATlON ENABLED ? 

10 



b c y 

UP. i*x 

; 

NO 

l 1 



ASH 

H3 

; 

HALVE PRINTER'S WIDTH 

12 



MOV 

P0.LP.Pl G 

i 

RE-INI T I ALlZE THE FLAG 

13 



• £ H U C 




14 3 w 3 4 6 

15 3 vj 3 4 6 

0 0 v 7 3 2 

LP.1XXS 

b* 

UP. 1^6 

9 

SUPPRESS CARRIAGE-RETURN 

1 5 v'i 3 30 0 


UP.I14J 

. IH OF 

L&l 1 ASPkUAD 



17 



1ST 

UP. PUG 



la 



b fe Q 

up.iyy 



19 



o p a 

P 1 i *i 1 6 



2# 



6 C'-v 

UP. I«4 



21 


LP.1YT S 





22 



.ENOC 




25 

120127 

V i vj !/• - :'J c. 2 


ORB 

P 1 » c2g 



24 33334 

4 0 1 4 1 5 


RNfc 

UP. H7 

9 

NO 

2 5 w n 3 5 a 

4 1 2 7 !<■ ' 1 
id W V" 4 1 2 


l y 0 v 

«S«.lP2,hl 

; 

substitute appropriate char 

26 00302 

120127 

4 0 & # 1 2 

LP.115J 

ORB 

R 1 . « 1 2 

i 

LINEFEED (12) ? 

27 303^6 

0 4 2 4 1 0 


»LT 

UP. 117 

9 

NO, BELOW 

<23 3 w <> 7 0 

V- l 4 £■ 3 


new 

UP, Ilf* 

9 

YES 

29 00372 

12.7-12/ 

0 0 t < 0 13 


op a 

P 1 , « 1 3 

9 

VERTICAL TAB (13) ? 

30 i* a 0 7 5 

001/1 7 


b £ w 

UP, ('HP 

9 

YES, IGNORE IT 1 

31 





9 

NO, FORMFEED (14) isolated 

3 2 i-i W 4 <d m 

33 0 0 4 0 14 

0 1 b 7 0 3 

177412 

LP.llbJ 

ri 0 V 

UP.SlZ.H3 

9 

R3 * -( PRINTER'S WIDTH ) 

3 4 00 4 id 4 

0/j54 0 3 


i v * t (? 

K3 

9 


35 



. I POP 

US1 lASPKfcAO 



36 



! ST 

IP. fug 

9 

elongation enabled ? 

37 



bfcU 

UP, 1(02 

9 

no, print character 

3a 



ASH 

R 3 

9 

halve PRINTER'S WIDTH 

39 



noV 

k3 . LP . P L.G 

# 

9 

RE-INITIALIZE the flag 

43 



• t-NOC 




4 1 0^4 4 6 

id 0 £ 07b 


&* 

UP . I (0*| 

9 

print the character 
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OV.uPC 


1 

0 4 0 4 1 *a 

w 12/0 1 

0 tf 0440 

up • 1 1 7 : 

/' 0 V 

«4<i . K l 

• 

9 

UNPRINTABLE, BLANK SUBSTITUTE 

2 

00 0 4 14 

0 0 vi o 7 5 


6 ^ 

LP.IU3 

« 

9 

PRINT A BUANK 

0 

0 0 v?416 

12/127 

00/172 

UP.I16S 

CvPd 

Rl , « 1 7 2 

} 

UOPfcR CASE AUPHABET ? 

4 

0004 22 

0 00 '0 0 0 


dUT 

LP.IU 

9 

EXCEEDS 

0 

6 



9 

9 


LUrtEK CASE TO 

UPPER CASE CONVERSION PERFORMED 

/ 

6 

000424 

042/01 

0 0 (V0 4 ,;1 

9 

dlC 

» <l (i , R l 

• 

CONVERSION PERFORMED 

9 

00 0 4 5 0 

v ; 00Ob2 


d k 

LP.I«3 

; 

print character 

1‘4 

00452 

I2i/127 

00/177 

LF.ilRT 

e m p b 

R 1 » A 1 7 7 

* 

9 

KUBOIIT C 1 77 ) ? 

1 1 

0 0 4 5 6 

00 1 o 7 7 


H£u 

LP.UNP 

• 

9 

YES, IONOHEO 

12 

00440 

126727 

1 770D4 

00/107 


c;<sp6 

UPPCAS, *137 

9 

UPPER CASE PERMITTED ? 

10 

vs 0 4 4 f> 

101250 


dHX 

UP. 1^3 

1 

YES, PRINT CHARACTER 

H 

0 0 4 0 A 

00/757 


h*-? 

UP. 117 

« 

I 

UNPRINTABLE, blank substitute 

15 








16 

0 0 4 D 2 

0 0 5 0 0 0 

LF.I2*>S 

ULC 

R3 

? 

backup print position 

17 

00454 

1^50 D; 2 


up e 

«2 

? 

BACKUP BUFFER POSITION 

16 

w 04 56 

»; 0 4 05/ 

/ 0 / 0 5 2 

LP. 121 : 

oSN 

Rb, LP.SEl 

1 

KESTQRt TEMPORARIES 

1^ 

0 ill 4 0 2 

v 5 2 7 0 7 
/ 4 /• 1 / / 

1 7 7 D l 4 


d 1 0 

«lu?t FRLP.CSK 

1 

tNABLE INTERRUPT 

2/5 

0 0 4 7 0 

/• 0/0 o .i 2 


KT1 


? 

exit from Interrupt 

21 








22 

0M/2 

>/\ (4 6 0 m 0 

LF.122S 

U tC 

K3 

/ 

BACKUP print POSITION 

25 

0 0 4 7 4 

0055 / 2 


ouc 

K2 

y 

BACKUP BUFFER POSITION 

24 

0fc> 4 7 b 

k-j 1 b 7 4 n 
177012 

LP.tRK! 

0 V 

UP. MAP, -UP) 

f 

DEVICE DRIVER'S MNEMONIC 

25 

7 4 D 4 2 

012746 

V) \0 / 4/2 


6 0 V 

*f A /j 0 ^ * - UP) 

? 

message cooe 

26 

405*46 

0 / v* 3 / 4 


lul 




2/ 

0 0 5 1 4 

0 0 z 16 7 

177074 


J >1p 

UP. 1 N T 

; 

TRY AGAIN 
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ov.LPyj 1 

naCU'U Ve 5*42 l7*JUL«i 

i 

i 


2 

; 


3 

• 

# 


4 00 0 5(4 

dlgOi’l UP • S f 3 5 

v *0 V 

3 0 0 vi 5 1 * 

4110 4 0 

M 0 V 

6 0 v 1 0 3 2 0 

0 0 5 '4 \A 2 

CUK 

7 4 0 /i 0 2 2 

■ f ;> 1 4 2 6 0 

0*0 v 


4 0 0 0 e 2 


9 ( d 0 0 52 6 

015/12 

h .) V 


0 4 v' 2 0 2 


9 0 -A V) 5 3 2 

41010/ 

M 0 V 

14 



H 4^d34 

0 1 0 4 0/ L P • 5 1 1 • 

0i GV 


1/7266 


12 0034*;. 

0 1 0 3 0 / 

h 0 V 


17/26 1 


15 0 0 3 4 

A i / 26/ 

MOV 


1/7262 


14 00550 

416004 

0 0V 


0 0 4 0 1 A 


15 00554 

A 12000 

MUV 


<5 A A 0 « 6 


15 4 0 0 0 0 

0 12 0 ; ■■’ i 

00 V 

17 00D92 

0 1200 2 

M 0 V 

1 a 0 4 5 0 4 

A 12 0 /> 5 

>*i 0 V 

19 00595 

A Yj 0 2 >/. 0 

k r 3 

24 

0 0 V VJ ■/’ 1 f 

• £Ni) 

OV.U* 5 ^ 

riAChfJ V£S**2 17 

* 0 0 L * 


6 /HBU L. TABLfc 


025 3* pa (it a 


INTEKRUP'T SIMULATOR 


(SP)+,K1 

t 

9 

RETURN PC 

(SPT »-(SPj 

1 

OLO PC 

R2 

1 

ADDRESS PS (-2) 

-CK2J ,2(5P) 

? 

old status 

PALP.TRP+2, (R2) 

1 

NEW STATUS 

R1,PC 

t 

RETURN 

R4, LP.8KS 

} 

RESTORE TEMPORARIES 

RiftP.LXN 

1 


R2,LP.BAD 

; 


10CSP) » K4 

; 

RESTORE REGISTER 4 

CSP1+,6(3P) 

; 

RETAIN RETURN ADDRESS 

tSP)+,Ri 

; 

RESTORE REGISTERS 

tSP)+,R2 

; 


CSP ) + , R3 

9 


MS 

; 

EXIT SUBROUTINE 


02*30 P A G t 6 " 1 


A042 » 

0 vj VJ 4 0 2 


UP 

0000W0RG 

LPTYP • 

004000 

LP.3A0 

i4 4 0 0 32 ^ 


LP.31^3 

000026 R 

LP.CLS 

000036R 

UP.CStf c 

1/7514 


UP.OBPa 

1/7516 

LP.DNE 

004252R 

UP •O0P 

0 0 0 2 36 4! 


L P • 0 U n 

4442 56R 

UP. ERR 

400476R 

I.P f { N T 

/3 0 W 1 1 A H 


U p , 1 XX 

4443AhR 

UP. 10 

000124R 

UP. I*"* 

A'AA \ 364 


UP. 101 

444102k 

LP. 102 

0 0 0 1 7 0 R 

wP. 143 

4 vi 2 1 / 0 4 


LP. 134 

040202R 

UP, 105 

000230R 

uP.I^o 

0 '5 2 3 4 4 


UP. 110 

8M02/4R 

LP.I1 1 

000306R 

lMi« 

0 p5 0 3 1 vj 4 


UP, 113 

044322k 

LP. 1 1 4 

000350R 

UP, 115 

0 0 0 3 0 2 4 


UP, 110 

4 4 4 4 4 50 R 

LP . 1 1 7 

0 0 0 4 1 0 R 

up.ua 

4 0 /) 4 1 f) 4 


UP. 119 

4 4 4 4 4 2 R 

LP . I 20 

000452R 

uR.m 

0034364 


UP. 122 

1 -J 4 4 / 2 K 

LP.LIN 

000024R 

v. P , L U w ■ 

0 3 3 0 4 fr'. 


LP.'VAM 

4 4 4 4 1 4 R 

LP.OPN 

400036R 

UP . Sc. T 

6 a a 3344 


up.su 

0 4 4 0 1 6 R 

UP . STS 

004514R 

up. rCT 

0 4 3 /• 3 3 4 


UP, TUF 

040034R 

LP.TRN 

000060R 

U p . T R R 3 

0 A A 2 A 10 


LP. T4T 

040206R 

LP 1 1 ■ 

000001 

0 V P R w T 

3 v.i tfj ✓< 2 2 4 


$«UP2 ■ 

44.54 1? 

S.RSAY* 

400044 

UPPCAS 

0300204 


4 I U T H B 

150151 lies 



• ArtS , 

0 vj vJ 0 0 « 

0 00 






0 3 0 3 7 0 

001 






u 9 2 Q 5 0 fc \ c C 1 c U 2 *> 

F*££ C 0 K fc • -WMl. kOKUS 

*LPt/C^<OT 5 L P 0 ^ f V 0 1 
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CROSS TAOLfc 


$ - 1 


Adda 

1-4 9# 

7-2^ 


LP 

2- 2* 

2- 7* 

2-16 

c p ftp 

1-ls 

1 -2 1 

2-21 

1, P , 0 A L > 

2-39* 

3- G-ft 

3-350 

LP.d*s 

2-37* 

4-1 3 

8-110 

lP.CLS 

2-2w 

3- 5* 


LP.CSK 

2-3^.« 

4 - 4 £■ 

4-29 

LP.O&H 

2-31* 

4-3*0 

4*350 

LP.O^fc 

5- n * 



uP. «)*P 

4- i 7 

4-$a 

4*36* 

uP.OQH 

4- * 

5- 7fc 


L P . £ P K 

4- t 

7-?4* 


L P . i ,,J T 

2 - 1 0 

3-10 

4- 3# 

LP. IXX 

6-14* 



LP.Itfl 

4- 5 

4 - 7 fc 


UPt 

4-16* 

4 - 4 1 


LP. 1^1 

4- Id* 



L P . 1 *5 'i 

4*25* 



L P . 1 '? <3 

4-27* 

4-36 

7 - 2 

LP. IPA 

4-2Q* 

6-4 1 


LP.iPSi 

4-33 

4-3&fc 


LP.XtfS 

4-37* 

6-10 


LP, I U 

4-19 

5-1 <2* 


LP.Ul 

5 * 2 3 * 



lP « 1 1 2 

5-29* 



L P • U <3 

3-13 

6- 1* 


LP.U4 

6-2 

6-16# 


lP. 1 1 5 

6- 3 

6-20# 


LP. 116 

0- b 

6-26 

6-32* 

LP.I1/ 

6-24 

6-?7 

7- 1 4 

LP. 119 

4-26 

7- 3* 


LP.119 

7- 4 

7 - 1 4 tt 


lP, 12*) 

4-31 

7-164 


LP.,121 

6- 5 

7-l6<? 


LP. 122 

4 - 3 5s 

7-22* 


lp.lIn 

2-3r>* 

4- 1 4 

8-120 

L P . L P » 

2 - D 1 * 

4-16 


L p . 'j A M 

2-27* 

7*24 


LP.OPiM 

2 - l 8 

3- 3fc 


L P , S t T 

5- t> 

7-16 

6-1 IK 

lp.su 

2-33* 

5- 1 7 

h • -5 

LP. its 

3 - 6 

3-36 

8- 4 4 

l p . r l t 

2-38* 

3-130 

3-3 50 

LP.IOP 

2-41 * 

3 - 7 


L P . T * IM 

2-19 

3-32# 


LP. (HP 

2-29* 

8- 6 


LP. IHT 

4 — 3 9* 

5-33 


LPU 

1-2 3* 



LSll 

2- 8 

2-H 

2-45 


5-24 

6 - 0 

6-13 

0 V P K N T 

2-35* 

6- 4 


PC 

1-47* 

3- oe 

3-330 

p«} 

1-40* 

3-3«$ 

3-35 

PI 

1-41* 

3- 70 

3- 8 


b- 1 

6 - 2 3 



d- 4$ 

8 - 9 

6-150 

P2 

i-42* 

3-13 

4-1 1 


6- 

8-13 

8-17* 


2-18 2-15 3-34 

4-lb 6-130 

b- 4 7-150 

8-40 ^-11 

7-27 

7- 9 7-14 


7-14 


6-33 

3-370 4. 7 4-39* 


2-47 

o-3b 

3- 9 

3-12 

-J-15 

6 - 9 0 

3-36 

Jm 9«* 

5-iH 


4-12 

4-lbP 

4-ie 

4-25 

6-26 

b-29 

7- 1? 

7 - 3 

4-150 

4-lfc 

7-1/0 

7-230 


5- 9 


3-20 


4-36 

7- a* 

8 - 6 * 


5-18 

5-12 

7- 10 

8- 7 
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Cr^OSO 

N £ K t K t iM C 

*3 

A - 4 3 * 
7-1 b0 

P 4 

1-44 5# 

*5 

1-45*? 

$ *1P2 

1-24* 

$P 

i-4«>* 
s> - 4 y * 

3 - 1 5 * 

3PAC6.S 

4-2i* 

OPr<t«U 

2- 8 
5-35 

a , n $ a v 

1-51* 

uppcab 

2-54* 

uo r i 

l-3h 

4 

3 - 7 


T A p l t 6 - 2 


4 - 1 *? 

4-140 

7-2*0 

8-12 

4- y 

4 - 1 ,3 0 

5- *?0 
5-20 

5- 80 

4 - y 0 

4-13* 

5-3*S* 

0-3 1 

a- io 

8-17 

2-1 i 

2-47 

5- 7 

4-2 5 

7-12 

2-10 

2-3.il 


4-270 

0-23 

8-180 


4-32® 

4-376* 

7-180 

0- l&P 

4-110 

4-12® 

7-240 

7-26* 

8-18 


3-15 

3«2tf 


- 6 <® 6 - 7 * 

5-29 5-31* 

5 - 7 * 5* a 

8- 4 8- 5* 

5-18 5-24 


6-33* 

6-34* 

8-11 

8-14* 

S- 1 7 P 

5-23* 

8- 7 P 

8-14 

00 

t 

iO 

6-16 


C U $ *5 *< £ 8 £ ■* t. “ C t T A y L t C - 1 

5329s 
, A B S * 5329o 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software , as well as programming 
notes , software problems , and documentation corrections , are published 
by Software Information Service in the following newsletters. 

DIGITAL Software News for the PDP-8 and PDP-12 
DIGITAL Software News for the PDP-11 
DIGITAL Software News for 18-bit Computers 

These newsletters contain information applicable to software available 
from DIGITAL'S Software Distribution Center. Articles in DIGITAL 
Software News update the cumulative Software Performance Summary which 
is included in each basic kit of system software for new computers. 
To assure that the monthly DIGITAL Software News is sent to the 
appropriate software contact at your installation , please check with 
the Software Specialist or Sales Engineer at your nearest DIGITAL 
office. 

Questions or problems concerning DIGITAL'S software should be reported 
to the Software Specialist. If no Software Specialist is available, 
please send a Software Performance Report form with details of the 
problems to: 

Digital Equipment Corporation 
Software Information Service 
Software Engineering and Services 
Maynard, Massachusetts 01754 

These forms, which are provided in the software kit, should be fully 
completed and accompanied by terminal output as well as listings or 
tapes of the user program to facilitate a complete investigation. An 
answer will be sent to the individual, and appropriate topics of 
general interest will be printed in the newsletter. 

Orders for new and revised software manuals, additional Software 
Performance Report forms, and software price lists should be directed 
to the nearest DIGITAL field office or representative. USA customers 
may order directly from the Software Distribution Center in Maynard. 
When ordering, include the code number and a brief description of the 
software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user 
library and publishes a catalog of programs as well as the DECUSCOPE 
magazine for its members and non-members who request it. For further 
information, please write to: 

Digital Equipment Corporation 
DECUS 

Software Engineering and Services 
Maynard, Massachusetts 01754 
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READER 1 S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve 
the quality and usefulness of its publications. To do this effectively 
we need user feedback — your critical evaluation of this document. 


Did you find errors in this document? If so, please specify by page. 


How can this document be improved? 


How does this document compare with other technical documents you 
have read? 
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